feat(*): Wire clerkUIVersion through all framework packages #7740

nikosdouvlis · 2026-02-03T10:02:32Z

Summary

Wire clerkUIVersion option through all framework packages to allow specifying a custom @clerk/ui version.

Add clerkUIVersion to Astro's AstroClerkIntegrationParams type
Pass through environment variables for all framework packages

🤖 Generated with Claude Code

Summary by CodeRabbit

New Features
- Introduced clerkUIVersion across integrations (Next.js, Nuxt, React Router, TanStack React Start, Express, Astro).
- Exposes UI version via public/runtime envs and includes it in provider/init state and script options so version flows to clients.
Chores
- Added a changeset to mark these packages for patch updates.

Why: The `clerkUIVersion` prop was typed in `@clerk/shared/types` but never wired through framework packages, making it effectively dead code. Users could pass the prop without TypeScript errors, but it would be silently ignored. This mirrors the existing `clerkJSVersion` functionality for `@clerk/ui`. What changed: - Added `NEXT_PUBLIC_CLERK_UI_VERSION` env var support to Next.js - Added `PUBLIC_CLERK_UI_VERSION` env var support to Astro - Added `VITE_CLERK_UI_VERSION` env var support to React Router and Tanstack Start - Added `CLERK_UI_VERSION` env var support to Express - Added `NUXT_PUBLIC_CLERK_UI_VERSION` env var support to Nuxt - Wired the prop through SSR state for React Router and Tanstack Start

vercel · 2026-02-03T10:02:38Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
clerk-js-sandbox	Ready	Preview, Comment	Feb 10, 2026 1:38am

changeset-bot · 2026-02-03T10:02:41Z

🦋 Changeset detected

Latest commit: 1b36a20

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 6 packages

Name	Type
@clerk/astro	Patch
@clerk/express	Patch
@clerk/nextjs	Patch
@clerk/nuxt	Patch
@clerk/react-router	Patch
@clerk/tanstack-react-start	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

coderabbitai · 2026-02-03T10:07:34Z

📝 Walkthrough

Walkthrough

This pull request threads a new Clerk UI version field through multiple packages. It adds CLERK_UI_VERSION / NEXT_PUBLIC_CLERK_UI_VERSION environment exposures, introduces clerkUIVersion into environment loaders and runtime config, and propagates clerkUIVersion and clerkUIUrl into provider/state shapes and script URL builders across Astro, Express, Next.js, Nuxt, React Router, and TanStack React Start packages. No control-flow changes; changes are additions to returned objects, constants, types, and config values.

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 16.67% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately reflects the main objective of the changeset: wiring clerkUIVersion through multiple framework packages for consistent UI version configuration.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

No actionable comments were generated in the recent review. 🎉

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

coderabbitai

Actionable comments posted: 0

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (2)

packages/react-router/src/server/utils.ts (1)

80-103: ⚠️ Potential issue | 🟠 Major

Add tests for clerkUIVersion propagation before merge.

This PR introduces a new runtime configuration path (__clerkUIVersion in the SSR clerk state), but no tests were added/updated to cover it. Please add a unit or integration test to validate that the env var is correctly read and serialized into the response state.

packages/react-router/src/client/types.ts (1)

6-28: ⚠️ Potential issue | 🟠 Major

Add tests for clerkUIVersion env/config propagation.

No tests were added or updated for this multi-framework change (env parsing, runtime config, script URL generation). Please add coverage to ensure the new clerkUIVersion wiring is respected end‑to‑end before merge.

pkg-pr-new · 2026-02-03T10:12:47Z

Open in StackBlitz

@clerk/agent-toolkit

npm i https://pkg.pr.new/@clerk/agent-toolkit@7740

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@7740

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@7740

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@7740

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@7740

@clerk/dev-cli

npm i https://pkg.pr.new/@clerk/dev-cli@7740

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@7740

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@7740

@clerk/express

npm i https://pkg.pr.new/@clerk/express@7740

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@7740

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@7740

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@7740

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@7740

@clerk/react

npm i https://pkg.pr.new/@clerk/react@7740

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@7740

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@7740

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@7740

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@7740

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@7740

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@7740

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@7740

commit: 1b36a20

coderabbitai

Actionable comments posted: 1

🤖 Fix all issues with AI agents

In `@packages/astro/src/integration/create-integration.ts`:
- Around line 177-180: The object literal defines PUBLIC_CLERK_UI_VERSION twice;
remove the duplicate entry so only one envField.string({ context: 'client',
access: 'public', optional: true }) remains for PUBLIC_CLERK_UI_VERSION (keep
the existing one at line that first defines PUBLIC_CLERK_UI_VERSION and delete
the later duplicate), ensuring there are no duplicated keys in the mapping
alongside PUBLIC_CLERK_PREFETCH_UI and PUBLIC_CLERK_UI_URL.

packages/astro/src/integration/create-integration.ts

nikosdouvlis added 2 commits February 3, 2026 11:52

chore: trigger CI

71d20cd

github-actions bot added nextjs express tanstack astro react-router nuxt core-3 labels Feb 3, 2026

coderabbitai bot reviewed Feb 3, 2026

View reviewed changes

chore: add changeset

0d40bab

vercel bot deployed to Preview February 3, 2026 10:09 View deployment

Ephem approved these changes Feb 3, 2026

View reviewed changes

Merge branch 'main' into nk/wire-clerk-ui-version

8685399

vercel bot deployed to Preview February 3, 2026 18:09 View deployment

Merge branch 'main' into nk/wire-clerk-ui-version

82bd8d9

vercel bot deployed to Preview February 6, 2026 04:37 View deployment

Merge branch 'main' into nk/wire-clerk-ui-version

7232e0b

vercel bot deployed to Preview February 6, 2026 19:04 View deployment

Merge branch 'main' into nk/wire-clerk-ui-version

d7ba456

vercel bot deployed to Preview February 9, 2026 20:36 View deployment

coderabbitai bot reviewed Feb 9, 2026

View reviewed changes

packages/astro/src/integration/create-integration.ts Outdated Show resolved Hide resolved

fix(astro): Remove duplicate PUBLIC_CLERK_UI_VERSION env field

f5269fe

vercel bot temporarily deployed to Preview February 9, 2026 20:54 Inactive

Merge branch 'main' into nk/wire-clerk-ui-version

1b36a20

vercel bot deployed to Preview February 10, 2026 01:38 View deployment

nikosdouvlis merged commit ed8dc4d into main Feb 11, 2026
39 checks passed

nikosdouvlis deleted the nk/wire-clerk-ui-version branch February 11, 2026 10:17

nikosdouvlis added a commit that referenced this pull request Feb 12, 2026

feat(*): Wire clerkUIVersion through all framework packages (#7740)

fd958a3

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(*): Wire clerkUIVersion through all framework packages #7740

feat(*): Wire clerkUIVersion through all framework packages #7740

Uh oh!

nikosdouvlis commented Feb 3, 2026 •

edited by coderabbitai bot

Loading

Uh oh!

vercel bot commented Feb 3, 2026 •

edited

Loading

Uh oh!

changeset-bot bot commented Feb 3, 2026 •

edited

Loading

Uh oh!

coderabbitai bot commented Feb 3, 2026 •

edited

Loading

Walkthrough

Uh oh!

coderabbitai bot left a comment

Uh oh!

pkg-pr-new bot commented Feb 3, 2026 •

edited

Loading

Uh oh!

coderabbitai bot left a comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

feat(*): Wire clerkUIVersion through all framework packages #7740

feat(*): Wire clerkUIVersion through all framework packages #7740

Uh oh!

Conversation

nikosdouvlis commented Feb 3, 2026 • edited by coderabbitai bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Summary by CodeRabbit

Uh oh!

vercel bot commented Feb 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

changeset-bot bot commented Feb 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

coderabbitai bot commented Feb 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Uh oh!

coderabbitai bot left a comment

Choose a reason for hiding this comment

Uh oh!

pkg-pr-new bot commented Feb 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitai bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

nikosdouvlis commented Feb 3, 2026 •

edited by coderabbitai bot

Loading

vercel bot commented Feb 3, 2026 •

edited

Loading

changeset-bot bot commented Feb 3, 2026 •

edited

Loading

coderabbitai bot commented Feb 3, 2026 •

edited

Loading

pkg-pr-new bot commented Feb 3, 2026 •

edited

Loading